2021.1 (latest)

Task References

On this page:

concat (string)

Purpose

The string concat task is used to combine strings. Essentially, this task can concatenate strings or an array of strings that may consist of one or more values. This task does not provide you with the ability to reorganize the array, or iterate through the array.

Potential Use Case

Use this task if you need to append one or more string values to the end of another string. The concatenated result will return a new string that contains the combined strings. For example, if you need to append some data records, you could potentially use concat to lay the groundwork to compile the results. Let's say you have a notification message that needs to be appended, the concat method could potentially be used to generate the new combined message.

Note: The concat task does not change the value of the original string.

Properties

Incoming Type Description
str String Required. The first string to concatenate (add to).
stringN Array or String Required. A string or array of strings to concatenate (add to) to the str value.


Outgoing Type Description
combinedStrings String The combined string that results from adding the value of stringN to str (in order as presented in the array).

Examples

Example 1

In this IAP example:

  • The str variable has been statically set to Hello World.

  • The stringN array has been populated with a single item: you will have high success today.

    • Notice the enclosure of the stringN value within square brackets to indicate an array.
    • Also notice the comma that follows the first double quote. The comma is not required, but is used for the mere purpose of sentence structure. It is important to know that the concatenation process does not add spaces or other characters between the two variables.

    stringConcat1

  • The outgoing combinedStrings variable will have the value of Hello World, you will have high success today.

    stringConcat1

Example 2

In this IAP example:

  • The str variable has been statically set to Hello World.

  • The stringN array has been populated with two items enclosed within square brackets: you will have high success today and go forth and prosper.

    • Notice that both items in the stringN value are enclosed within square brackets to indicate an array.
    • Again, the punctuation is not required but used in this example for purposes of sentence structure in the outgoing result. The concatenation process does not add spaces or other characters between variables.

    stringConcat1

  • The outgoing combinedStrings variable will have the value of Hello World, you will have high success today, go forth and prosper.

    stringConcat1